Sound.id3

Доступность

Flash Player 6; начиная с Flash Player 7 поведение было изменено.

Синтаксис

my_sound.id3:Object

Описание

Свойство, доступное только для чтения; предоставляет доступ к тэгам MP3 файла.

MP3 файл может содержать мета информацию, ID3 тэги. Если MP3 файл, загруженный в звуковой объект при помощи Sound.attachSound() или Sound.loadSound(), содержит ID3 тэги, Вы можете получить к ним доступ. Поддерживаются только ID3 тэги в кодировке UTF-8.

Flash Player 6 (6.0.40.0) и более поздние версии поддерживают как ID3 1.0, так и ID3 1.1. Flash Player 7 поддерживает также ID3 тэги версии 2.0, в частности 2.3 и 2.4. В таблице ниже перечислены стандартные ID3 тэги версии 2.0 и их описания; доступ к тэгам можно получить, воспользовавшись синтаксисом my_sound.id3.COMM, my_sound.id3.TIME и так далее. MP3 файлы могут содержать тэги, не перечисленные в таблице; Sound.id3 предоставляет доступ ко всем тэгам.

Свойство

Описание

COMM

Комментарий

TALB

Название альбома

TBPM

Количество ударов в минуту.

TCOM

Композитор

TCON

Content type, тип содержимого

TCOP

Авторские права

TDAT

Дата

TDLY

Задержка (playlist delay)

TENC

Кодировщик

TEXT

Автор текста

TFLT

Тип файла

TIME

Время

TIT1

Группа содержимого (content group description)

TIT2

Описание названия песни / заголовка

TIT3

Уточнее подзаголовка

TKEY

Инициализирующий ключ

TLAN

Язык(и)

TLEN

Длина

TMED

Тип данных

TOAL

Название оригинального альбома

TOFN

Оригинальное имя файла

TOLY

Автор оригинального текста

TOPE

Первый исполнитель

TORY

Год выпуска

TOWN

Владелец файла / лицензия

TPE1

Исполнители

TPE2

Оркестр / аккомпанимент

TPE3

Уточнение исполнителя

TPE4

Микширован, изменен ...

TPOS

Часть сета

TPUB

Издатель

TRCK

Номер трэка или позиция в сете

TRDA

Дата записи

TRSN

Название интернет-радиостанции

TRSO

Владелец интернет-радиостанции

TSIZ

Размен

TSRC

ISRC (стандартный международный код записи)

TSSE

Программное / аппаратное обеспечение и настройки

TYER

год

WXXX

URL

Flash Player 6 поддерживает только ID3 тэги версии 1.0. Если какого-либо из них нет в тэгах первой версии, но они содержатся в том же MP3 файле в тэге версии 2.0, тэги версии 2.0 копируются в ID3 1.0, как показано в таблице ниже. Это сделано для обратной совместимости.

ID3 2.0 tag

Соответствующий ID3 тэг версии 1.0

COMM

Sound.id3.comment

TALB

Sound.id3.album

TCON

Sound.id3.genre

TIT2

Sound.id3.songname

TPE1

Sound.id3.artist

TRCK

Sound.id3.track

TYER

Sound.id3.year

Пример

В следующем примере на панель Output выводятся тэги файла song.mp3:

var my_sound:Sound = new Sound();
my_sound.onID3 = function(){
  for( var prop in my_sound.id3 ){
    trace( prop + " : "+ my_sound.id3[prop] );
  }
}
my_sound.loadSound("song.mp3", false);

См. также

Sound.attachSound(), Sound.loadSound()